Einführung
Die Automatisierung der Dokumentenerstellung kann Ihre Produktivität erheblich steigern, insbesondere wenn Sie mehrere Vorlagen und Datensätze verwalten. Während die Web-App von DocuGenerate eine umfassende Lösung bietet, möchten Sie möglicherweise Dokumentengenerierungs-Funktionen in Ihre eigene Bubble-Anwendung integrieren.
Deshalb haben wir ein Bubble-Plugin entwickelt, mit dem Sie die Leistung der DocuGenerate-API direkt in Ihren Bubble-Apps nutzen können. In diesem Tutorial zeigen wir, wie wir mit Bubble und unserem Plugin eine vereinfachte Version von DocuGenerate erstellt haben – ganz ohne Code!
Wie die App Funktioniert
Um ein besseres Gefühl für das zu bekommen, was wir erstellen werden, können Sie sich die Bubble- Demo-App ansehen. Die folgende Animation demonstriert eine vollständige Benutzerreise durch die Anwendung, von der Vorlagenerstellung bis zur Dokumentgenerierung und zum Download.

Die typische Benutzerreise folgt diesen Schritten:
- Vorlagenerstellung: Eine Word-Vorlage mit Merge-Tags hochladen und ihr einen Namen geben.
- Vorlagen durchsuchen: Vom Dashboard aus alle verfügbaren Vorlagen durchsuchen.
- Vorlagenauswahl: Auf eine Vorlage klicken, um ihre Details und zuvor generierte Dokumente anzuzeigen.
- Dokumentgenerierung: Über die „+”-Schaltfläche zum Dokumentgenerierungsformular navigieren.
- Dateneingabe: Einen Dokumentnamen angeben, ein Ausgabeformat auswählen und die JSON-Daten eingeben.
- Generierung: Nach dem Klicken auf „Generate” wird das Dokument mithilfe der DocuGenerate-API erstellt.
- Dokumentzugriff: Zur Vorlage-Detailseite zurückkehren und das neue Dokument ansehen.
Dieser Workflow spiegelt die Kernfunktionalität der Web-App von DocuGenerate wider, ist jedoch vollständig in Bubble implementiert. Die nahtlose Integration zwischen Bubbles visueller Entwicklungsplattform und der DocuGenerate-API schafft eine leistungsstarke und dennoch zugängliche Dokumentengenerierungslösung.
Ihr Bubble-Projekt Einrichten
Bevor wir mit dem Erstellen unserer App beginnen, müssen wir die Entwicklungsumgebung vorbereiten. Bubbles visuelle Plattform macht diesen Prozess einfach, aber es gibt einige wesentliche Schritte:
- Registrieren Sie sich für ein Bubble-Konto, falls Sie noch keines haben.
- Erstellen Sie eine App in Bubble und geben Sie ihr einen Namen.
- Installieren Sie das DocuGenerate-Plugin in Ihrer neuen App.
- Konfigurieren Sie das Plugin mit Ihrem DocuGenerate-API-Schlüssel.

Was Ist im DocuGenerate-Plugin Enthalten?
Das DocuGenerate-Bubble-Plugin bietet einen umfassenden Satz von API-Aufrufen, die die Funktionalität unserer REST-API widerspiegeln. Diese sind in zwei Typen kategorisiert:
Data Calls
Diese werden verwendet, um Informationen aus Ihrem DocuGenerate-Konto abzurufen:
- List Templates: Gibt alle in Ihrem Konto verfügbaren Vorlagen zurück.
- Get Template: Ruft detaillierte Informationen zu einer bestimmten Vorlage ab.
- List Documents: Gibt alle aus einer bestimmten Vorlage generierten Dokumente zurück.
- Get Document: Ruft detaillierte Informationen zu einem bestimmten Dokument ab.
Actions
Diese werden verwendet, um Ressourcen in Ihrem DocuGenerate-Konto zu erstellen, zu ändern oder zu löschen:
Das Verständnis dieser API-Aufrufe ist wesentlich, da sie das Rückgrat unserer Demo-Anwendung bilden. Im Verlauf dieses Tutorials werden wir die meisten dieser Aufrufe verwenden, um einen vollständig funktionsfähigen Dokumentengenerierungs-Workflow zu erstellen.
Die App-Navigation Gestalten
Bevor wir uns mit den einzelnen Seiten befassen, richten wir die Navigationsstruktur ein, die alle Teile unserer Anwendung verbindet. Ein einheitliches Navigationssystem ist entscheidend für ein reibungsloses Benutzererlebnis. Wir haben eine einfache Navigationsleiste erstellt, die oben auf jeder Seite erscheint und Folgendes enthält:
- Das DocuGenerate-Logo auf der linken Seite, das als Home-Schaltfläche dient und auf das Dashboard verweist.
- Eine New Template-Schaltfläche auf der rechten Seite, die Benutzer direkt zur Vorlagenerstellung führt.

Diese Navigationsstruktur spiegelt den in der eigentlichen Web-App von DocuGenerate verwendeten Ansatz wider und bietet eine vertraute Erfahrung für Benutzer, die unsere Hauptplattform bereits kennen. Das bekannte Layout hilft Benutzern, intuitiv durch die Anwendung zu navigieren, ohne dass zusätzliche Anweisungen erforderlich sind.
Die Dashboard-Seite
Die Dashboard-Seite dient als zentraler Hub unserer Anwendung und bietet Benutzern sofort einen Überblick über alle verfügbaren Vorlagen. Da dies der erste Bildschirm ist, den Benutzer beim Öffnen der App sehen, ist er sowohl informativ als auch intuitiv gestaltet und ermöglicht schnellen Zugriff auf die wichtigsten Funktionen.

Wie in der Web-Oberfläche von DocuGenerate haben wir Vorlagen in einem visuell ansprechenden Rasterlayout organisiert, das Vorlagenvorschauen neben ihren Namen anzeigt. Dieser visuelle Ansatz macht es einfach, die gesuchte Vorlage schnell zu finden, auch wenn Dutzende verschiedener Vorlagen verwaltet werden.
So Erstellen Sie Es:
- Erstellen Sie ein RepeatingGroup-Element, um die Vorlagen anzuzeigen.
- Setzen Sie die Datenquelle auf den List Templates-Data Call des DocuGenerate-Plugins.

- Gestalten Sie jedes Rasterelement mit:
- Einem Textelement für den Vorlagennamen
- Einem Bildelement für die Vorlagenvorschau

- Fügen Sie einen Workflow zum Bildelement hinzu, sodass beim Klicken zur Vorlage-Detailseite navigiert wird und die Vorlagen-ID als URL-Parameter übergeben wird.

Die Schlüsselkomponente ist die RepeatingGroup, die sich automatisch mit allen Vorlagen aus Ihrem DocuGenerate-Konto füllt. Dieser dynamische Ansatz stellt sicher, dass das Dashboard immer die aktuellste Vorlagenliste anzeigt, ohne manuelle Updates zu erfordern.
Jede Vorlage im Raster ist anklickbar und navigiert zu einer detaillierten Ansicht dieser spezifischen Vorlage. Das Dashboard integriert sich auch nahtlos mit unserer Navigationsleiste, die die New Template-Schaltfläche für den schnellen Zugriff auf die Vorlagenerstellung enthält.
Die Vorlagenerstellungsseite
Auf dieser Seite beginnen Benutzer den Dokumentengenerierungsprozess, indem sie ein Word-Dokument hochladen, das als Vorlage dient. Dieser entscheidende Schritt legt die Grundlage für alle nachfolgende Dokumentgenerierung, da die hochgeladene Vorlage die Struktur, Formatierung und Merge-Tags enthält, die bei der Generierung von Dokumenten verwendet werden.
Wir haben diese Seite so gestaltet, dass sie unkompliziert und fokussiert ist, unnötige Ablenkungen beseitigt und Benutzer durch den Vorlagenerstellungsprozess führt. Die Oberfläche kommuniziert klar, was erforderlich ist (ein Word-Dokument und ein Name), und gibt sofortiges Feedback, wenn die Vorlage erfolgreich erstellt wurde.

So Erstellen Sie Es:
- Fügen Sie ein FileUploader-Element hinzu, um Benutzern die Auswahl ihres Word-Dokuments zu ermöglichen.

- Fügen Sie ein Eingabefeld für den Vorlagennamen hinzu.
- Fügen Sie eine „Create Template”-Schaltfläche mit folgendem Workflow hinzu:
- Beim Klicken die Create Template-Action des DocuGenerate-Plugins aufrufen
- Die Datei aus dem FileUploader als
file-Parameter über die dynamische Link-Option übergeben - Den Namen aus dem Eingabefeld als
name-Parameter übergeben 
- Nach dem Erstellen der Vorlage zur Vorlage-Detailseite mit der neuen Vorlagen-ID navigieren

Dieses optimierte Formular übernimmt alles, was zum Erstellen einer Vorlage in DocuGenerate erforderlich ist. Die FileUploader-Komponente bietet eine native Möglichkeit für Benutzer, Dateien von ihrem Gerät auszuwählen, mit Drag-and-Drop-Unterstützung und klarem visuellem Feedback.
Nach der Erstellung der Vorlage schafft die automatische Navigation zur Vorlage-Detailseite einen nahtlosen Übergang zum nächsten Schritt im Workflow. Diese durchdachte Benutzerreise beseitigt die Notwendigkeit, manuell zwischen Seiten zu navigieren.
Die Vorlage-Detailseite
Die Vorlage-Detailseite dient als zentraler Hub für die Verwaltung einer bestimmten Vorlage und aller daraus generierten Dokumente. Diese Seite vereint wesentliche Vorlageninformationen mit Dokumentverwaltungsfunktionen und bietet eine umfassende Ansicht der Nutzung und Ausgabe jeder Vorlage.
Im Gegensatz zu den einfacheren Seiten, die wir bisher erstellt haben, integriert die Vorlage-Detailseite mehrere Datenquellen und interaktive Elemente, um eine komplexere und funktionalere Oberfläche zu schaffen. Wir haben diese Elemente sorgfältig organisiert, um trotz der erhöhten Komplexität Klarheit zu bewahren.

So Erstellen Sie Es:
- Erstellen Sie ein Group-Element als Container für den Seiteninhalt.
- Setzen Sie die Datenquelle der Gruppe auf den Get Template-Data Call des DocuGenerate-Plugins, mit dem
id-Parameter auf die template_id aus der URL gesetzt. 
- Fügen Sie ein Textelement hinzu, um den Vorlagennamen anzuzeigen.
- Fügen Sie ein Bildelement hinzu, um die Vorlagenvorschau anzuzeigen.

- Fügen Sie eine RepeatingGroup für die Dokumentenliste hinzu mit:
- Datenquelle auf den List Documents-Aufruf mit dem
template_id-Parameter gesetzt - Jedes Element zeigt den Dokumentnamen als Link zur
document_uri zum Herunterladen 
- Fügen Sie eine „+”-Schaltfläche hinzu, die zur neuen Dokumentseite navigiert.

Der leistungsstärkste Aspekt dieser Seite ist die Art und Weise, wie das Group-Element die Datenquelle nutzt, um allen untergeordneten Elementen Vorlagendaten zur Verfügung zu stellen. Dieses Muster, manchmal als „Datenvererbung” in Bubble bezeichnet, stellt sicher, dass alle Elemente auf der Seite automatisch aktualisiert werden, wenn eine andere Vorlage ausgewählt wird.
Die Dokumentenliste bietet eine chronologische Ansicht aller aus dieser Vorlage generierten Dokumente, mit den neuesten Dokumenten oben. Jeder Dokumenteintrag enthält einen direkten Download-Link, sodass Benutzer schnell auf ihre generierten Dateien zugreifen können.
Die prominente „+”-Schaltfläche dient als klarer Call-to-Action und führt Benutzer zum Dokumentgenerierungsprozess. Beim Klicken navigiert sie zur Dokumentgenerierungsseite und übergibt die Vorlagen-ID, um den Kontext beizubehalten.
Die Dokumentgenerierungsseite
Hier kommt die eigentliche Stärke der Dokumentgenerierung zum Ausdruck und ermöglicht es Benutzern, ihre Daten mit Vorlagen zu verbinden, um angepasste Dokumente zu erstellen. Wir haben diese Seite so gestaltet, dass sie leistungsstark und dennoch zugänglich ist und erweiterte Funktionalität mit einer klaren Oberfläche in Einklang bringt.
Diese Seite behält die visuelle Konsistenz mit der Vorlage-Detailseite bei und zeigt dieselben Vorlageninformationen oben an, um Kontext zu liefern. Dadurch können Benutzer bestätigen, dass sie mit der richtigen Vorlage arbeiten, bevor sie mit der Dokumentgenerierung fortfahren.

So Erstellen Sie Es:
- Zeigen Sie die Vorlageninformationen an (Name und Vorschau) ähnlich wie auf der Vorlage-Detailseite.
- Erstellen Sie ein Formular mit:
- Einem Texteingabefeld für den Dokumentnamen
- Einem Dropdown für die Auswahl des Ausgabeformats (PDF, DOCX, DOC, ODT, TXT, HTML, PNG)
- Einem MultiLine Input für die Eingabe der JSON-Daten

- Fügen Sie eine „Generate”-Schaltfläche hinzu, die:
- Die Generate Document-Action des DocuGenerate-Plugins aufruft
- Alle Formularwerte als Parameter übergibt, zusammen mit der
template_id aus der URL 
- Nach der Generierung zur Vorlage-Detailseite zurücknavigiert

Das MultiLine-Eingabefeld ist besonders wichtig, da es eine flexible Möglichkeit für Benutzer bietet, ihre JSON-Daten einzugeben. Dieser Ansatz unterstützt sowohl einfache Datenstrukturen für grundlegende Dokumente als auch komplexe verschachtelte Objekte oder Arrays für anspruchsvollere Generierungsszenarien.
Das Ausgabeformat-Dropdown demonstriert einen der Hauptvorteile von DocuGenerate: die Fähigkeit, Dokumente in mehreren Formaten aus einer einzigen Vorlage zu generieren. Benutzer können das Format wählen, das ihren Anforderungen am besten entspricht, sei es ein PDF für die formale Verteilung, ein DOCX für weitere Bearbeitung oder ein anderes Format für spezifische Anwendungsfälle.
Nach der Generierung des Dokuments navigiert die Seite automatisch zur Vorlage-Detailseite zurück, wo das neu erstellte Dokument oben in der Liste erscheint. Dieses sofortige Feedback bestätigt, dass die Generierung erfolgreich war.
Erweiterungsmöglichkeiten
Obwohl unsere Demo-App die wesentliche Funktionalität für die Dokumentgenerierung bietet, gibt es viele Möglichkeiten, sie zu erweitern:
- PDF-Vorschau: Statische Bilder durch eingebettete PDF-Vorschauen von Vorlagen und Dokumenten ersetzen.
- Alternative Ansichten: Optionen hinzufügen, um Vorlagen als Liste statt als Raster anzuzeigen.
- Vorlagenbearbeitung: Benutzern erlauben, Vorlagen zu aktualisieren mit neuen Dateien oder geänderten Einstellungen.
- Vorlagennavigation: Ein Dropdown oder eine Suchleiste hinzufügen, um einfach zwischen Vorlagen zu navigieren.
- Tabellenkalkulationsunterstützung: Die Möglichkeit hinzufügen, Excel- oder CSV-Dateien für die Dokumentgenerierung hochzuladen.
Diese Erweiterungen würden unsere Demo-App von einem Proof of Concept zu einer vollständig ausgestatteten Dokumentengenerierungslösung transformieren. Das Schöne an Bubbles visueller Entwicklungsplattform ist, dass diese Funktionen schrittweise hinzugefügt werden können, sodass die Anwendung zusammen mit den Benutzeranforderungen wachsen kann.
Fazit
Das Erstellen einer Dokumentengenerierungs-App mit Bubble und dem DocuGenerate-Plugin demonstriert die Stärke der No-Code-Entwicklung in Kombination mit spezialisierten APIs. Die von uns erstellte Demo-App dient sowohl als Proof of Concept als auch als Ausgangspunkt für Ihre eigenen Dokumentenautomatisierungs- projekte. Durch die Nutzung von Bubbles visueller Entwicklungsplattform und den Dokumentengenerierungs- fähigkeiten von DocuGenerate können Sie maßgeschneiderte Lösungen für Ihre spezifischen Anforderungen erstellen, ohne eine einzige Zeile Code schreiben zu müssen.
Dieser Ansatz ist besonders wertvoll für Unternehmen ohne dedizierte Entwicklungsteams oder für solche, die Dokumentengenerierungs-Workflows schnell prototypisieren und iterieren möchten. Die visuelle Natur von Bubble macht es für Business-Analysten, Betriebsspezialisten und andere nicht-technische Teammitglieder zugänglich und befähigt sie, Lösungen zu erstellen, die ihre Dokumentenautomatisierungsherausforderungen direkt angehen.
Ob Sie interne Tools für Ihr Team oder kundenseitige Anwendungen erstellen, dieser Ansatz bietet eine schnelle und flexible Möglichkeit, Dokumentengenerierungsfunktionen zu implementieren. Die Kombination aus Bubbles intuitiver Oberfläche und der leistungsstarken API von DocuGenerate schafft eine Synergie, die ausgeklügelte Dokumentenautomatisierung für Organisationen jeder Größe zugänglich macht.
Ressourcen